docs(profile): portfolio-first org README — convert with proof, not prose#2
Merged
Merged
Conversation
…rose
Restructure the Agent-Field org profile from a ~140-line manifesto into
a ~55-line portfolio-first page that converts visitors to stars.
Why
- Org READMEs convert when they answer "what cool stuff did these people
ship?" in 3 seconds. The previous version led with philosophy paragraphs;
the showcase table — the strongest social proof — was buried mid-page.
- Catalog was stale: linked 5 apps (one with a broken redirect), missing
4 newly-shipped ones (plandb, pr-af, reels-af, cloudsecurity-af,
roboscribe-af).
- Star CTA appeared only at the bottom; 80% of visitors never saw it.
Changes
- Hero: punchy tagline ("The best DX for production AI agents") + stat
chips (2.1k stars, 9 production apps, Apache 2.0) + 3 nav links.
- Top-of-page star CTA — pulled from footer.
- "Built on AgentField" portfolio table now has all 9 shipped apps with
approximate star counts (snapshot — refresh quarterly).
- "What is AgentField?" condensed to 2 sentences using the developer-DX
framing.
- "Why this org exists" compressed from 3 paragraphs into 3 bullets.
- Removed the static hero.png — same rationale as the agentfield repo;
text + portfolio table do the job without the bytes.
Target: visitor lands → sees star CTA → scrolls portfolio → "they built
all this on AgentField" → stars the platform.
Iteration based on review:
- Drop hardcoded "2.1k stars" and "9 production apps" chips — any count
in the page will rot. Replace per-repo stars with live shields.io
badges (branded muted-gold label, dark value); always current.
- Reframe hero with stronger developer focus:
· Tagline: "Build agents like services. Scale them beyond chatbots."
· Paragraph 1: category — what AgentField is (AI Backend, infra for
long-running agents with identity, audit, APIs)
· Paragraph 2: DX — write Python/Go/TS, get the production layer
built in
- Move Star CTA into the inline nav row (bold-weighted) — remove the
blockquote CTA that read as tacked-on; remove the footer CTA blockquote
too (top CTA + showcase proof is enough)
- Merge "What is AgentField?" into the hero (was redundant)
- Move vs-frameworks comparison link to the bottom of "Why this org
exists" — natural reading flow
…shields rate limit
- Hero had two back-to-back paragraphs that read as duplicate subtitles
("AgentField is the AI Backend ..." + "Write normal Python ...").
Collapsed into one crisp paragraph that combines category framing
with the DX list.
- Add cacheSeconds=3600 to every shields.io star badge. Some badges were
showing "Unable to select next GitHub token from pool" — shields.io's
rate-limit error when its global GitHub token pool is exhausted.
Caching for 1 hour cuts ~24x of the API calls and prevents recurrence.
…end agents Every row now leads with 'Autonomous backend', 'Background pipeline', or 'Agent-native backend' framing to convey: these are services running in the background, not human-facing chat tools. Words like 'no analyst in the loop', 'no human direction', 'lights-out', 'before a human ever opens it' reinforce the autonomy theme.
…ples link Hero - Add new cinematic 21:9 hero image (Option D) — isometric three-plate stack with gold middle plate (= AgentField as the layer between Your Services and Agent Fleet). Designed in the AgentField deck-slide aesthetic (warm near-black bg, gold accents, hairline rules, monospace side labels) - Image baked-in tagline: "Build agents like APIs." (DX promise) - Image compressed via pngquant: 4.7MB → 287KB (16x smaller, no visible quality loss; sips-resized to 1920w max) Hero copy - Combine the two pitch lines into ONE paragraph that opens with the category framing and lands with the capability list, reinforcing rather than repeating the image. Single visual block: image + one paragraph + CTA row. No clutter. Examples link - Add "See all examples on agentfield.ai →" footer under the showcase table. Lets readers go deeper without us having to maintain every example in the README. The org repos list + this link cover both audiences (curious vs. exploring).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Restructure the Agent-Field org profile from a ~140-line manifesto into a ~55-line portfolio-first page that converts visitors to stars.
Problems with the current README
af-swe-claudeinstead ofSWE-AF).What changes
Conversion path
vs the previous:
Test plan